From 50106521d6ee485b80fb7b298ad22e0fb028bf0e Mon Sep 17 00:00:00 2001 From: Daniel Boles Date: Tue, 19 Sep 2017 00:05:09 +0100 Subject: [PATCH] Window: Clarify documentation of set_application() MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Clarify that ::destroy, not ::hide*, removes a window from its app, by replacing the mention of open windows with the blurb on destruction from :application, completing commit 7db4bee4b62bc9b6f20ba4e599e8d030314984fd Also link to the equivalent gtk_application_(add|remove)_window() calls, since Application.add_window() already links back to Window:application. * unless you use gtkmm… https://bugzilla.gnome.org/show_bug.cgi?id=639931 --- gtk/gtkwindow.c | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c index 0e98e9eeb1..589dd31dfa 100644 --- a/gtk/gtkwindow.c +++ b/gtk/gtkwindow.c @@ -3593,12 +3593,20 @@ gtk_window_release_application (GtkWindow *window) /** * gtk_window_set_application: * @window: a #GtkWindow - * @application: (allow-none): a #GtkApplication, or %NULL + * @application: (allow-none): a #GtkApplication, or %NULL to unset * * Sets or unsets the #GtkApplication associated with the window. * - * The application will be kept alive for at least as long as the window - * is open. + * The application will be kept alive for at least as long as it has any windows + * associated with it (see g_application_hold() for a way to keep it alive + * without windows). + * + * Normally, the connection between the application and the window will remain + * until the window is destroyed, but you can explicitly remove it by setting + * the @application to %NULL. + * + * This is equivalent to calling gtk_application_remove_window() and/or + * gtk_application_add_window() on the old/new applications as relevant. * * Since: 3.0 **/ -- 2.30.2